home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Extra 1997 #4 / Amiga Plus Extra 1997 #4.iso / pd / grafik / gallery / gallery.doc < prev    next >
Text File  |  1997-06-09  |  7KB  |  220 lines
  1. Gallery - (c) 1996,97 by Markus Hillenbrand
  2. ===========================================
  3.  
  4.  
  5.  
  6. PURPOSE
  7.  
  8.     This program is intended for creating nice looking HTML pages with small 
  9.     thumbnails of pictures. It creates a gallery where you can click through 
  10.     (in order to see the pictures). 
  11.     This piece of software is written in a forthcomming C++ class library for 
  12.     the Amiga, which is easy to use and intuitive. If you are interested in 
  13.     this class library, feel free to contact me. 
  14.     
  15.  
  16. REQUIREMENTS
  17.  
  18.     Amiga Operating System v 39
  19.     GfxCon 1.7 (not included in the package, get it from aminet)
  20.     web browser which can handle tables and frames (only in order to see the 
  21.     results)
  22.     
  23.     
  24. INSTALLATION
  25.  
  26.     You only have to click on the «install» icon. If you want to install it 
  27.     by hand, just copy the executable «Gallery» to any place on your hard disk.
  28.     
  29.     You must get a program which can create thumbnails. I prefer GfxCon from
  30.     Dirk Farin. You can get it from aminet or other PD sources. If you have
  31.     found and installed a program, just start gallery and turn to the page
  32.     'Thumbnails'. Here you can enter a system call to create the thumbnails.
  33.     There must be four arguments in this string gadget (%s %s %ld %ld). The
  34.     first argument will be filled with the picture's file name, the second
  35.     with the thumbnail's file name. The third and fourth argument are the
  36.     width and height of the thumbnail to be generated.
  37.     
  38.     If you start the program for the first time, there will be a preset for
  39.     the usage with GfxCon. Just have a look at it, and change the path to
  40.     the correct directory GfxCon resides in.
  41.     
  42.     Hope, you got it. If not, feel free to e-mail me.
  43.     
  44.     
  45.     
  46. USAGE FROM CLI
  47.  
  48.     There is no usage from CLI anymore. If you enter 'Gallery' in your Shell,
  49.     the GUI will pop up.
  50.         
  51.         
  52. USAGE FROM WORKBENCH
  53.  
  54.     Just click on the program's icon and the window will pop up.
  55.     Any function the window offers is described in the botton line
  56.     of the window. Just move the mouse around.
  57.  
  58.         
  59.         
  60. HISTORY
  61.  
  62.     Gallery 39.7
  63.       Removed GfxCon from the package.
  64.       Added a status window.
  65.       Removed shell usage.
  66.       A program to create the thumbnails can be entered by the user.
  67.       Changed the source code to pure C++ code.
  68.       The background pattern will be shown correctly now.
  69.       
  70.     Gallery 39.6
  71.       Gallery entries are sorted correctly now (Stricmp instead of strcmp)
  72.       Now you can create thumbnails for every picture found. Upto 39.5 
  73.       gallery only created thumbnails for pictures which could be shown
  74.       in a HTML file. 
  75.       
  76.     Gallery 39.5
  77.       Works together with AFS now. Thanks to Timm S. Müller!
  78.       Now you can create a non frames gallery.
  79.       
  80.     Gallery 39.4:
  81.       Designed the GUI with a register gadget.
  82.       More control over HTML files.
  83.       Small enhancements in HTML code.
  84.       
  85.     Gallery 39.3:
  86.       Now you can specify lines and columns of the HTML tables.
  87.       Prefs are now saved correctly.
  88.       Found some small bugs, and removed them.
  89.       
  90.     Gallery 39.2:
  91.       Galleries are now shown in frames
  92.       GfxCon is now called correcty with '"' for filenames
  93.       There are five rows now instead of four.
  94.       
  95.     Gallery 39.1:
  96.       Graphical user interface added
  97.       MAXENTRIES added
  98.       Gallery entries will be sorted by name
  99.       changed version numbering to style guide
  100.               
  101.     Gallery 1.0:
  102.       First release for aminet
  103.             
  104.             
  105. FUTURE
  106.  
  107.     These features might be added to future versions:
  108.     
  109.     - more control of generated html files
  110.         
  111.         
  112. COPYRIGHT
  113.  
  114.     Gallery (c) 1996,97 by Markus Hillenbrand
  115.     
  116.     Permission is granted to make and distribute verbatim copies of this
  117.     manual provided the copyright notice and this permission notice are
  118.     preserved on all copies.
  119.  
  120.     No guarantee of any kind is given that the program described in this
  121.     document is 100% reliable. You are using this material at your own risk.
  122.     The author *can not* be made responsible for any damage which is caused
  123.     by using these programs.
  124.  
  125.     This package is freely distributable, but still copyright by
  126.     Markus Hillenbrand. This means that you can copy it freely as long as you
  127.     don't ask for more than nominal copying fee.
  128.  
  129.     Permission is granted to include this package in Public-Domain collections.
  130.     The distribution file may be uploaded to Bulletin Board Systems or FTP 
  131.     servers. If you want to distribute this program you must use the unmodified
  132.     distribution archive.
  133.  
  134.     Gallery must NOT be included or used in commercial programs unless by
  135.     written permission from the author. 
  136.  
  137.     Gallery must NOT be used on any machine which is used for the research,
  138.     development, construction, testing or production of weapons or other
  139.     military applications. This also includes any machine which is used for
  140.     training persons for *any* of the above mentioned purposes.
  141.  
  142.  
  143. REGISTRATION
  144.  
  145.     Well, this package is not crippled anyhow. But please tell me if you use
  146.     the program. So I can decide whether to continue this work or not.
  147.     Just send me an e-mail or a post card.
  148.     
  149.     CAUTION: If you develop any commercial software with this tool (for 
  150.     example a CD rom with pictures), you must send me a copy of it. This 
  151.     piece of software is free for private usage only.
  152.  
  153.  
  154. BUGS
  155.  
  156.     None.
  157.  
  158.  
  159. IMPORTANT NOTES
  160.  
  161.     - Only pictures that have a correct suffix (i.e. .GIF, .IFF, .JPG, ...)
  162.       will be scanned and put into the gallery.
  163.     
  164.  
  165. AUTHOR
  166.  
  167.     The author can be reached as:
  168.     
  169.       Markus Hillenbrand
  170.       Mannheimer Straße 28
  171.       67655 Kaiserslautern
  172.       GERMANY
  173.         
  174.       E-Mail: Markus.Hillenbrand@t-online.de
  175.               m_hillen@informatik.uni-kl.de
  176.                         
  177.       Internet: http://www.student.uni-kl.de/~hillenbr
  178.         
  179.       Telephone:    (+49) 631/696561
  180.  
  181.  
  182. KNOWN USERS
  183.  
  184.     Timm S. Müller      (Timm.Mueller@darmstadt.netsurf.de)
  185.      
  186.     Ronald Schmiers     (rosch@freiepresse.de)
  187.     
  188.     Chris Dodd          (cjdodd@csm.uwe.ac.uk)
  189.                         (http://www.geocities.com/SiliconValley/Lakes/3186/index.HTML)
  190.                        
  191.     Royan Webb          (bandr@globaldialog.com)
  192.                         (http://www.globaldialog.com/AdventureCentral)
  193.                        
  194.     Mike Timm           (mike@ai.inka.de)
  195.                         (http://privat.swol.de/MikeTimm)
  196.                        
  197.     Phil Snell          (fruity@dillusio.demon.co.uk)
  198.                         (http://www.dillusio.demon.co.uk/danii)
  199.                        
  200.     Rigo Sievert        (R.Sievert@bbrandes.berlinet.de)    
  201.     
  202.     Francisco J Carmona Almagro (carmona@adam.es);
  203.                         (http://webs.adam.es/carmona)
  204.                        
  205.     Robert Cherry Mountains (klr@quadrant.xs4all.nl)
  206.                        
  207.     Paolo Maggi         (pmaggi@telnetwork.it)
  208.     
  209.     Thomas Hasemann     (MisterB@t-online.de)
  210.     
  211.     Wouter van Straalen (W.R.vanStraalen@CyberDude.com)
  212.                         (http://www.worldonline.nl/~knmg1421)
  213.                         
  214.     Andy Gardner        (valkyrie@enterprise.net)
  215.     
  216.     Torbjörn Aronsson   (Torbjorn.Aronsson@mailbox.swipnet.se)
  217.                         (http://home1.swipnet.se/~w-12327)
  218.                         
  219.  
  220.